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This document describes the sourco languago and operation oT HU, the Alto 
microassembler. HU is downward compatible with DEBAL, the original Alto 
assembler/debugger, but hns a number of" additional features. MU is implemented 
in BCPL, and runs on tho Alto. 

The source lan guage 

An Alto microprogram consists oT a number of s tateme nts and comments. 
Statcnents are terminated by semicolons, and everything between tho semicolon 
and tho next CR is treated as a comment. Statements "can thus span sevoral text 
lines (tho current limit is ?.5G characters maximum). All other control 
characters and blanks arc ignored. 

Statements ore of three basic types: declarations, address prcdof initions, and 
executable code. The syntax and semantics of tfioso constructs is as follows: 

Declarat ions 

Declarations are of three types: symbol definitions, constant definitions, ajfd 
R memory nancs. 

Symbol pnfiniti ons 

Symbol definitions havo tho form: 

Jnome$Ln. ,n,,n, ; 

Tho symbol "nana" is defined, with values n,, n ? and n,. Thoro is a standard 
package of symbols for the Alto which should appear at tho beginning of every 
sourco program. For those who must add symbol definitions, the interpretation 
of the n's is given in tho appendix. 



Constant declarati ons 

Normal constants are declared thusly: 

SnamcSn; 



Because the symbol table is allocated above tho operating system, MU will 
currently run only on G4K Altos. 
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This declares a 16 bit unsigned constant with value n. Tho assembler assigns 
tho constant to the first free location in the constant mennry. unless the 
vnluo has appeared beforo under another name in which case the value of the 
name is the address of the proviously declared constant. An alternative 
constant definition is used for mask constants which have a specified bus 
sourco fiold (recall that the constant memory address is the concatination of 
the rscloct and bus source fields of the microinstruction). The syntax is: 



$name$fln:v; 



4<n<7, 0<v<2»»16 



N spocifios tho desired bus sourco valuo, v is the constant value. 

R Memory declarations 

R memory names arc defined with: 

JnamcJRn; 0<n<40B 
(100B if you have an Alto augmented with 32 extra R registers) 

An R location may havo several names. 

Address prodcf i n itions 

Address prodcf initions allow groups of instructions to lie placed in specified 
locations in tho control memory, as is required by the OR branding scheme used 
in tho Alto. Thoir syntax is: 

! n,k,naneO,nancl ,name2, ' " ' ,nnnck-l ; 

.This declaration causes a block of k consecutive locations to be allocated in 
tho instruction memory, and tho names assigned to them, n d<>riries tho location 
of tho block, in that if L is the address of the last location of the block, L 
and n = n. Usually, n will he 2**p-l for some small p. For example, if the 
prodcf inition 

! 3,4 , TooO, fool , foo2, foo3 ; 

is encountered in tho source text before any executable statements, the labels 
foo0-foo3 will be assigned to control mnnory locations 0-3. If there are too 
few names, they arc ossigncd to the low addresses in tho block. If there are 
too many, they arc discarded, and an error is indicated. If there are missing 
labels, e.g. "fooO, , foo2, ; ;", the locations remain available for the normal 
instruction allocation process. A predefinition must be the first nention of 
the name in the sourco text (forward references or labels encountered before a 
predefinition of a given unnc cause an error when the predefinition is 
encountered. ) 



Executa ble sjUVtcnen_ts 

Executable code statements consist of an optional label followed by a number of 
clausos separated by commas, and terminated with a semi-colon 

label: clause, clauso, clause" ' ; 

If n label has been predefined, the instruction is placed at the control memory 
locaion reserved for it. Otherwise, it is assigned to the lowest unused 
location. 

Clausos are of thrco typos: gotos, nondata functions, and assignments. 
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GOTO 

Goto clauses nrc of the Corn : label, and cause the value of the label to 

be assembled Into the K'LX'T fiold of the instruction. If the labol Is 

undefined, a chain of forward references is constructed which will be 
fixed up when the symbol is encountered as a label. 

Wonda ta Functio ns 

Nondnta functions must bn defined (by a literal symhol definition) before 

being encountered in a code clause. This type of clause assembles Into 

the F1.2, or 3 fields, and represents either a branch condition or a 
control function (e.g. BUS=0, TASK). 

Register transfer s (assignments) 

All register transfers are specified by assignments of tho form: 

rdesta-rdestb*-" * '-source 

This, typo of clause is assembled by looking up tho rdests, checking their 
legality, and making the field assignments implied by tho symbol types. 
Each destination inpor.es definitional requirements on the source (e.g. 
ALUOUTPUT must be defined, BUS must be defined).. These requirements must 
be satisfied by the source for ho statement to be legal. When the source 
is encountered, it is looked up in the symbol table. If it is legal and 
satisfies tho definition.!] requirements imposed by the destinations, tho 
necessary field assignments arc made, and processing continues. If tho 
entire source defines tho BUS, and the onl£ remaining requirement is that 
tho ALU output must be defined (e.g. l.-HI)j, the AI.UF field is set to 
(ALU OUTPUT = BUS), and processing continues. If neither of tho nbovo 
conditions holds, the source can legally bo'only of the form: "thing which 
defines the bus ' alu function." Tho soiree taken is broken into two 
substrings, and eacli is looked up in the symbol table. If two substrings 
can bo found which satisfy ttie requirements, the field assignments implied 
by both arc made. If the boundary between the two substrings is advanced 
to the end of the token without definition, an error is generated. This 
method of evaluation is simple, but it has pitfalls. For instance, L«- T+2 
is illegal, but L-Z+T is not, providing that tho constant "2" has been 
defined. 

Tho constant "0" is special, in that when one or more clauses in a 
statement reuirc that the bus be 0, the constant is not output, but a flag 
is sot. When processing of the statement is completed, if any clause has 
caused the R memory to be loaded, the constant is not used, since the 
hardware forces the bus to in this case. 

The destination "SINK" allows a clause to specify a bus source without 
specification of a destination. It is useful, for example in constructs 
of tho form: SINK-MASK CONSTANT. I.-DISP XOR T,, which will cause the 
value of DISC to be anded on the bus with the mask constant 



Operatio n 

Tho assembler is invoked with: 

HU/global switches sourcfile. optional extension listfile/L binfile/B 
Legal global .switches aro: 
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/L produce a listing file 

/D debug mode 

/N do not produce a binary file (overridden by binlile/H) 

If listfile/L is absent but the /L global switch is set, listiuo output will bo 
sent to sourccfile.LS. 

If binfilo/n is absent, binary output is sent to snurcof ile .Mil. 

Error messages will bo sent to tho listing file ir om> h.is hen specified, 
unless debug modu has been set. In debug node, errors are r.^ni in t».e systen 
display area, and a pause occurs at at every error (ami at certain other 
times). Typing any character proceeds. 

If no listing filo has been requested, debug node is set iinli-pi-rujfnt of the 
global switch. 

Output file 

The assembler produceds MICRO rornat binary output.' Th>- si.rin>j n.ir.os of tHo 
two memories specified in tho file are CONKTAM and INSIIl'( I w\ ;. n n lv defined 
locations in these memories are output. HKI'O format is o.Vip.it t !> I <• "wi th the 
PROM blowing program, and with KAHI.OAH, a description i>r ilu<!i i <. attached. 
Note that the instruction memory specified in ihr binary rile dot-, mt include 
tho 3 bit F3 field, which exists only in the debugging RAM. 



Listing filo 

Tho listing filo contains: 

1.) All orror messages (unless debug mode is set) 

2.) A listing of all unused but predefined locations and unresolved 
forward references. 

3.) A listing of the contents of the constant nenory 

4.) A listing of tho names assigned to tin- R monory 

5.) A listing of the object and source code (villi r., •-.-.. -nts and 
declarations removed. The 35 bit instruction is pr lnt>d out in the 
following order: 

LOCATION: RSEL ALUF BUS SOURCE Fl FZ LOAM. LOADT F3 
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Appendix I: Literal symbol definitions 



The value or a symbol is a 3 word quantity. Tho first word contains a type (6 
bits) and a value (10 bits) which dotenines tho interpretation or the symbol In 
all cases except when it is encountered as the source in a register transfer 
clause (assignment). Tho second word contains the type and value used In this 
case. Tho third word contains bits specifying, the definitional requirements 
and source attributes applied when the symbol is encountered in an assignment: 



BITO: I. OUTPUT MUST BE DEFINED' 
BIT1: IMS MUST HE DEFINED* 
BIT?.: ALM MUST BE DEFINED' 
BITS 3-7: 
BIT8: L IS DEFINED 

BITO: BUS IS DEFINED 
BIT10: ALU IS DEFINED 
BIT14: ALU OUTPUT IS DEFINED 
IF BUS IS DEFINED 



(USED BY LIIS PROCESSING) 

(LIES) 

(LIIS) 

(USED BY RIIS PROCESSING 

TO CHECK LEGALITY OF CLAUSE 

(RIIS) 

(RIIS) 

(USED BY RIIS 

PROCESSING WHEN SOURCE 

IS OF THE FORM 

"BUS DEFINER.ALU FUNCTION") 

Assignment processing proceeds by successively ORing the attribute words for 
the destinations with -1. When tho RIIS is rncountcred, the attribute word 
contains O'S in bits 0-2 for things which must bo defined. Legality of the 
source (if it is a defined symbol) is tested by computing 

DESTINATION ATTRIBUTES (0-2)' AND SOURCE ATTRIBUTES (fl-10) 

The bits in bits 0-2 of the result represent unsatisfied conditions. If tho 
only requirement is ALU definition, and if the BU.j Is defined, tho ALU function 
is set to gate tho bus through (denning the ALU}, and tho clause is complete. 
If this doesn't work, the source string is iSismcmbcred, looking for two 
substrings, the first of which defines the bus (hit9), and tho second of which 
defines tho ALU output if tho bus is defined (hitl4). If two substrings are 
found, the implied assignments arc made, and the clause is complete. 
Otherwise, an error is indicated. 

Tho symbol typo(s) determine the fields to bo set in tho microinstruction: Some 
types arc legal only as an isolated clause, some are legal only as the source 
or destination in an assignment. The currently defined types are: 

SIDE EFFECTS 



TYPE: 


LEGAL AS: 


INSTRUCTION FIELD 
RECEIVING VALUE 


ILLEGAL 


NEVER 




1 UNDEFINED ADDRESS 


ADDRESS 




2 DEFINED ADDRESS 


ADDRESS 


NEXT 


3 R LOCATION LIIS 


LIIS 


RSEL 


4 R LOCATION RNS 


RIIS 


RSEL 


5 -CONSTANT 


RNS 


RSEL.BS 


6 BUS SOURCE 


RIIS 


IIS 


7 NONDATA Fl 


CLAUSE 


Fl 


10 DA TAF I'- 


LIIS 


Fl 


ll -L DEFINING Fl 


RIIS 


Fl 


12 NONDATA F2 


CLAUSE 


F2 


13 DATA F2- 


LIIS 


F2 


14 -DATA F2 


RIIS 


F2 


15 DATAF2- 


LIIS 


F2 



DS-1 , UWBZ-TRUE , RSEL-0 
(-DNS.-ACDEST) 
BS-0, RSEL-0 
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1G 


END 


CLAUSE 


- 


17 


-L 


RIIS 


- 


20 


L- 


LIIS 


LOADL 


21 


NONDATA F3 


CLAUSE 


F3 


22 


DF3- 


LIIS 


F3 


23 


-DF3 


RIIS 


F3 


24 


-ALU FUNCTIONS 


RIIS 


ALUF 


25 


T- 


LIIS 


LOADT 


26 


-T 


RIIS 


ALUF 


27 


NO LONGER USED 






'30 


PREDEFINED ADDRESS 






31 


LMRSII.LHLSII 


RIIS 




32 


-MASK CONSTANT 


RIIS 




33 


-F2 


RIIS 


F2 


34 


-Fl 


RIIS 


Fl 



(Arm :.!• . •••■ .■■■•'■ ■\ci-) 
Ki.ri"..i. ii--; i'i ! :al 
■(Slum l.Ai- i m ;;l) 



sits Ai.i'i i' 



BS-Z 
BS-2 



Al.l'E 



Tho curront symbol definitions are attached. 



